Skip to content

fix(gh-aw): keep compiled expressions valid - #2037

Merged
bradygaster merged 5 commits into
devfrom
bradygaster-fix-gh-aw-bootstrap
Sep 14, 2026
Merged

bradygaster merged 5 commits into
devfrom
bradygaster-fix-gh-aw-bootstrap

Conversation

@bradygaster

Copy link
Copy Markdown
Collaborator

Summary

  • replace the activation-comments boolean with an equivalent form that survives gh-aw JSON serialization
  • add a mutation regression proving the previous && form emits invalid \\u0026\\u0026 inside a GitHub expression
  • document an emitted-lock scan in the gh-aw setup guide and enlistment skill mirrors

Root cause

gh aw compile --strict accepted the source, but gh-aw v0.89.2 serialized && as literal \\u0026\\u0026 inside ${{ ... }} in GH_AW_SAFE_OUTPUT_MESSAGES. GitHub rejected the resulting squad.lock.yml before creating any jobs, so the run had no logs.

Validation

  • targeted artifact regression: 2 passed
  • enlistment skill tests: 19 passed
  • clean install layout: 6/6 workflows strict-compiled; only documented bot-trigger warning
  • emitted lock scan: no JSON-escaped operators inside GitHub expressions
  • actionlint expression errors: 0
  • npm run build: passed

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings September 14, 2026 16:55
@github-actions

github-actions Bot commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor

🛫 PR Readiness Check

ℹ️ This comment updates on each push. Last checked: commit 1a23f01

PR Scope: 🔧 Infrastructure

⚠️ 2 item(s) to address before review

Status Check Details
❌ Single commit 5 commits — consider squashing before review
✅ Not in draft Ready for review
✅ Branch up to date Up to date with dev
❌ Copilot review No Copilot review yet — it may still be processing
✅ Changeset present Changeset file found
✅ Scope clean No .squad/ or docs/proposals/ files
✅ No merge conflicts No merge conflicts
✅ Copilot threads resolved All 1 Copilot thread(s) resolved
✅ CI passing All checks passing

Files Changed (10 files, +188 −15)

File +/−
.changeset/gh-aw-compiled-expression.md +8 −0
.github/agents.md +12 −0
.squad-templates/skills/gh-aw-enlistment/SKILL.md +10 −0
docs/src/content/docs/guide/gh-aw.md +45 −14
packages/squad-cli/templates/skills/gh-aw-enlistment/SKILL.md +10 −0
packages/squad-sdk/templates/skills/gh-aw-enlistment/SKILL.md +10 −0
templates/skills/gh-aw-enlistment/SKILL.md +10 −0
test/gh-aw-enlistment-skill.test.ts +36 −0
test/gh-aw-quality.test.ts +46 −0
workflows/squad.md +1 −1

Total: +188 −15


This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.

@github-actions

github-actions Bot commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor

🟠 Impact Analysis — PR #2037

Risk tier: 🟠 HIGH

📊 Summary

Metric Count
Files changed 10
Files added 1
Files modified 9
Files deleted 0
Modules touched 7

🎯 Risk Factors

  • 10 files changed (6-20 → MEDIUM)
  • 7 modules touched (5-8 → HIGH)

📦 Modules Affected

ci-workflows (1 file)
  • .github/agents.md
docs (1 file)
  • docs/src/content/docs/guide/gh-aw.md
root (3 files)
  • .changeset/gh-aw-compiled-expression.md
  • templates/skills/gh-aw-enlistment/SKILL.md
  • workflows/squad.md
squad-cli (1 file)
  • packages/squad-cli/templates/skills/gh-aw-enlistment/SKILL.md
squad-sdk (1 file)
  • packages/squad-sdk/templates/skills/gh-aw-enlistment/SKILL.md
templates (1 file)
  • .squad-templates/skills/gh-aw-enlistment/SKILL.md
tests (2 files)
  • test/gh-aw-enlistment-skill.test.ts
  • test/gh-aw-quality.test.ts

This report is generated automatically for every PR. See #733 for details.

bradygaster and others added 2 commits September 14, 2026 09:56
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Moderate findings remain for scan error handling and the required changelog or changeset.

Get a fresh assessment by requesting another Copilot review.

Review tier: Lite
Findings: 1 Medium severity

Open findings (1)
What changed in this PR

Updates gh-aw activation expressions to remain valid after JSON serialization and adds regression coverage and setup guidance.

Changes:

  • Replaces the unsafe && expression form.
  • Adds compiled-artifact and mutation regression tests.
  • Documents emitted-lock validation in guides and skill mirrors.
File Summary
workflows/​squad.md Updates the activation expression.
test/​gh-aw-quality.test.ts Adds serialization regression coverage.
templates/​skills/​gh-aw-enlistment/​SKILL.md Documents lockfile scanning.
packages/​squad-sdk/​templates/​skills/​gh-aw-enlistment/​SKILL.md Mirrors skill guidance.
packages/​squad-cli/​templates/​skills/​gh-aw-enlistment/​SKILL.md Mirrors skill guidance.
docs/​src/​content/​docs/​guide/​gh-aw.md Documents emitted-lock validation.
.squad-templates/​skills/​gh-aw-enlistment/​SKILL.md Updates canonical skill guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

bradygaster and others added 2 commits September 14, 2026 10:08
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@bradygaster
bradygaster merged commit f1229ed into dev Sep 14, 2026
19 checks passed
jplummer01 pushed a commit to jplummer01/squad that referenced this pull request Sep 17, 2026
Part of github#2037 and github#2038

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants